home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmMessageBox.z / XmMessageBox
Encoding:
Text File  |  2002-10-03  |  35.6 KB  |  529 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx - The MessageBox widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/MessageB.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           MessageBox is a dialog class used for creating simple
  19.           message dialogs.  Convenience dialogs based on MessageBox
  20.           are provided for several common interaction tasks, which
  21.           include giving information, asking questions, and reporting
  22.           errors.
  23.  
  24.           A MessageBox dialog is typically transient in nature,
  25.           displayed for the duration of a single interaction.
  26.           MessageBox is a subclass of BulletinBoard and depends on it
  27.           for much of its general dialog behavior.
  28.  
  29.           The default value for XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussssis the value of
  30.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.
  31.  
  32.           A typical MessageBox contains a message symbol, a message,
  33.           and up to three standard default PushButtons: OOOOKKKK,,,, CCCCaaaannnncccceeeellll,
  34.           and HHHHeeeellllpppp.  It is laid out with the symbol and message on top
  35.           and the PushButtons on the bottom. The HHHHeeeellllpppp button is
  36.           positioned to the side of the other push buttons.  You can
  37.           localize the default symbols and button labels for
  38.           MessageBox convenience dialogs.
  39.  
  40.           The user can specify resources in a resource file for the
  41.           gadgets created automatically that contain the MessageBox
  42.           symbol pixmap and separator. The gadget names are SSSSyyyymmmmbbbboooollll and
  43.           SSSSeeeeppppaaaarrrraaaattttoooorrrr.
  44.  
  45.           A MessageBox can also be customized by creating and managing
  46.           new children that are added to the MessageBox children
  47.           created automatically by the convenience dialogs.  In the
  48.           case of TemplateDialog, only the separator child is created
  49.           by default.  If the callback, string, or pixmap symbol
  50.           resources are specified, the appropriate child will be
  51.           created.
  52.  
  53.           Additional children are laid out in the following manner:
  54.  
  55.              +o  The first MenuBar child is placed at the top of the
  56.                 window.  The _X_m_Q_T_m_e_n_u_S_y_s_t_e_m trait is used to check
  57.                 that it is the first MenuBar child.
  58.  
  59.              +o  All widgets or gadgets are placed after the _O_K button
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                 in the order of their creation (this order is checked
  75.                 using the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e trait).
  76.  
  77.              +o  A child that is not in the above categories is placed
  78.                 above the row of buttons. If a message label exists,
  79.                 the child is placed below the label. If a message
  80.                 pixmap exists, but a message label is absent, the
  81.                 child is placed on the same row as the pixmap. The
  82.                 child behaves as a work area and grows or shrinks to
  83.                 fill the space above the row of buttons. The layout of
  84.                 multiple work area children is undefined.
  85.  
  86.           At initialization, MessageBox looks for the following bitmap
  87.           files:
  88.  
  89.              +o  xxxxmmmm____eeeerrrrrrrroooorrrr
  90.  
  91.              +o  xxxxmmmm____iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  92.  
  93.              +o  xxxxmmmm____qqqquuuueeeessssttttiiiioooonnnn
  94.  
  95.              +o  xxxxmmmm____wwwwoooorrrrkkkkiiiinnnngggg
  96.  
  97.              +o  xxxxmmmm____wwwwaaaarrrrnnnniiiinnnngggg
  98.  
  99.           See XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaapppp(3) for a list of the paths that are searched
  100.           for these files.
  101.  
  102.           MessageBox uses the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e and _X_m_Q_T_m_e_n_u_S_y_s_t_e_m
  103.           traits.
  104.  
  105.         DDDDeeeesssscccceeeennnnddddaaaannnnttttssss
  106.           MessageBox automatically creates the descendants shown in
  107.           the following table.  An application can use XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt
  108.           to gain access to the named descendant. In addition, a user
  109.           or an application can use the named descendant when
  110.           specifying resource values.
  111.           NNNNaaaammmmeeeedddd DDDDeeeesssscccceeeennnnddddaaaannnntttt   CCCCllllaaaassssssss                IIIIddddeeeennnnttttiiiittttyyyy
  112.           __________________________________________________________________________________________________________________________________________
  113.           CCCCaaaannnncccceeeellll             XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt   Cancel button
  114.           HHHHeeeellllpppp               XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt   Help button
  115.           MMMMeeeessssssssaaaaggggeeee            XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt        displayed message
  116.           _O_K                 XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt   OK button
  117.           SSSSeeeeppppaaaarrrraaaattttoooorrrr          XXXXmmmmSSSSeeeeppppaaaarrrraaaattttoooorrrrGGGGaaaaddddggggeeeetttt    dividing line between message
  118.                                                   and buttons
  119.           SSSSyyyymmmmbbbboooollll             XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt        icon symbolizing message type
  120.  
  121.         CCCCllllaaaasssssssseeeessss
  122.           MessageBox inherits behavior, resources, and traits from
  123.           CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd.
  124.  
  125.           The class pointer is _x_m_M_e_s_s_a_g_e_B_o_x_W_i_d_g_e_t_C_l_a_s_s.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           The class name is XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx.
  141.  
  142.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  143.           The following table defines a set of widget resources used
  144.           by the programmer to specify data. The programmer can also
  145.           set the resource values for the inherited classes to set
  146.           attributes for this widget. To reference a resource by name
  147.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  148.           prefix and use the remaining letters. To specify one of the
  149.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  150.           the XXXXmmmm prefix and use the remaining letters (in either
  151.           lowercase or uppercase, but include any underscores between
  152.           words).  The codes in the access column indicate if the
  153.           given resource can be set at creation time (C), set by using
  154.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  155.           not applicable (N/A).
  156.  
  157.                                             XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  158.           NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                 AAAAcccccccceeeessssssss
  159.           XmNcancelCallback      XmCCallback            XtCallbackList   NULL                    C
  160.           XmNcancelLabelString   XmCCancelLabelString   XmString         dynamic                 CSG
  161.           XmNdefaultButtonType   XmCDefaultButtonType   unsigned char    XmDIALOG_OK_BUTTON      CSG
  162.           XmNdialogType          XmCDialogType          unsigned char    XmDIALOG_MESSAGE        CSG
  163.           XmNhelpLabelString     XmCHelpLabelString     XmString         dynamic                 CSG
  164.           XmNmessageAlignment    XmCAlignment           unsigned char    XmALIGNMENT_BEGINNING   CSG
  165.           XmNmessageString       XmCMessageString       XmString         ""                      CSG
  166.           XmNminimizeButtons     XmCMinimizeButtons     Boolean          False                   CSG
  167.           XmNokCallback          XmCCallback            XtCallbackList   NULL                    C
  168.           XmNokLabelString       XmCOkLabelString       XmString         dynamic                 CSG
  169.           XmNsymbolPixmap        XmCPixmap              Pixmap           dynamic                 CSG
  170.  
  171.           XXXXmmmmNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk
  172.                     Specifies the list of callbacks that is called
  173.                     when the user clicks on the cancel button.  The
  174.                     reason sent by the callback is XXXXmmmmCCCCRRRR____CCCCAAAANNNNCCCCEEEELLLL.
  175.  
  176.           XXXXmmmmNNNNccccaaaannnncccceeeellllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  177.                     Specifies the string label for the cancel button.
  178.                     The default for this resource depends on the
  179.                     locale.  In the C locale the default is CCCCaaaannnncccceeeellll.
  180.  
  181.                     Now that some default localized label strings are
  182.                     provided through message catalogs for the children
  183.                     of composite widgets, the llllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg resources
  184.                     cannot be set on the child through default
  185.                     resource files.  Instead, the resource provided at
  186.                     the parent level must be used.
  187.  
  188.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnnTTTTyyyyppppeeee
  189.                     Specifies the default PushButton.  A value of
  190.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____NNNNOOOONNNNEEEE means that there should be no
  191.                     default PushButton.  The following types are
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     valid:
  207.  
  208.                        +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____CCCCAAAANNNNCCCCEEEELLLL____BBBBUUUUTTTTTTTTOOOONNNN
  209.  
  210.                        +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____OOOOKKKK____BBBBUUUUTTTTTTTTOOOONNNN
  211.  
  212.                        +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____HHHHEEEELLLLPPPP____BBBBUUUUTTTTTTTTOOOONNNN
  213.  
  214.                        +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____NNNNOOOONNNNEEEE
  215.  
  216.           XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTyyyyppppeeee
  217.                     Specifies the type of MessageBox dialog, which
  218.                     determines the default message symbol.  The
  219.                     following are the possible values for this
  220.                     resource:
  221.  
  222.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____EEEERRRRRRRROOOORRRR
  223.                               Indicates an ErrorDialog.
  224.  
  225.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  226.                               Indicates an InformationDialog.
  227.  
  228.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____MMMMEEEESSSSSSSSAAAAGGGGEEEE
  229.                               Indicates a MessageDialog.  This is the
  230.                               default MessageBox dialog type.  It does
  231.                               not have an associated message symbol.
  232.  
  233.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____QQQQUUUUEEEESSSSTTTTIIIIOOOONNNN
  234.                               Indicates a QuestionDialog.
  235.  
  236.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____TTTTEEEEMMMMPPPPLLLLAAAATTTTEEEE
  237.                               Indicates a TemplateDialog.  The
  238.                               TemplateDialog contains only a separator
  239.                               child. It does not have an associated
  240.                               message symbol.
  241.  
  242.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____WWWWAAAARRRRNNNNIIIINNNNGGGG
  243.                               Indicates a WarningDialog.
  244.  
  245.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____WWWWOOOORRRRKKKKIIIINNNNGGGG
  246.                               Indicates a WorkingDialog.
  247.  
  248.                     If this resource is changed with XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, the
  249.                     symbol bitmap is modified to the new XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTyyyyppppeeee
  250.                     bitmap unless XXXXmmmmNNNNssssyyyymmmmbbbboooollllPPPPiiiixxxxmmmmaaaapppp is also being set in
  251.                     the call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss.  If the dialog type does
  252.                     not have an associated message symbol, then no
  253.                     bitmap will be displayed.
  254.  
  255.           XXXXmmmmNNNNhhhheeeellllppppLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  256.                     Specifies the string label for the help button.
  257.                     The default for this resource depends on the
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     locale.  In the C locale the default is HHHHeeeellllpppp.
  273.  
  274.                     Now that some default localized label strings are
  275.                     provided through message catalogs for the children
  276.                     of composite widgets, the llllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg resources
  277.                     cannot be set on the child through default
  278.                     resource files.  Instead, the resource provided at
  279.                     the parent level must be used.
  280.  
  281.           XXXXmmmmNNNNmmmmeeeessssssssaaaaggggeeeeAAAAlllliiiiggggnnnnmmmmeeeennnntttt
  282.                     Controls the alignment of the message Label.
  283.                     Possible values include the following:
  284.  
  285.                        +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG (default)
  286.  
  287.                        +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR
  288.  
  289.                        +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD
  290.  
  291.                     See the description of XXXXmmmmNNNNaaaalllliiiiggggnnnnmmmmeeeennnntttt in the
  292.                     XXXXmmmmLLLLaaaabbbbeeeellllreference page for an explanation of these
  293.                     values.
  294.  
  295.           XXXXmmmmNNNNmmmmeeeessssssssaaaaggggeeeeSSSSttttrrrriiiinnnngggg
  296.                     Specifies the string to be used as the message.
  297.  
  298.           XXXXmmmmNNNNmmmmiiiinnnniiiimmmmiiiizzzzeeeeBBBBuuuuttttttttoooonnnnssss
  299.                     Sets the buttons to the width of the widest button
  300.                     and height of the tallest button if False. If this
  301.                     resource is True, button width and height are set
  302.                     to the preferred size of each button.
  303.  
  304.           XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk
  305.                     Specifies the list of callbacks that is called
  306.                     when the user clicks on the OK button.  The reason
  307.                     sent by the callback is XXXXmmmmCCCCRRRR____OOOOKKKK.
  308.  
  309.           XXXXmmmmNNNNooookkkkLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  310.                     Specifies the string label for the OK button.  The
  311.                     default for this resource depends on the locale.
  312.                     In the C locale the default is _O_K.
  313.  
  314.                     Now that some default localized label strings are
  315.                     provided through message catalogs for the children
  316.                     of composite widgets, the llllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg resources
  317.                     cannot be set on the child through default
  318.                     resource files.  Instead, the resource provided at
  319.                     the parent level must be used.
  320.  
  321.           XXXXmmmmNNNNssssyyyymmmmbbbboooollllPPPPiiiixxxxmmmmaaaapppp
  322.                     Specifies the pixmap label to be used as the
  323.                     message symbol.
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 10/3/02)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  335.  
  336.  
  337.  
  338.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  339.           MessageBox inherits behavior and resources from the
  340.           superclasses described in the following tables.  For a
  341.           complete description of each resource, refer to the
  342.           reference page for that superclass.
  343.  
  344.                                       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  345.           NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  346.           XmNallowOverlap        XmCAllowOverlap        Boolean          True            CSG
  347.           XmNautoUnmanage        XmCAutoUnmanage        Boolean          True            CG
  348.           XmNbuttonFontList      XmCButtonFontList      XmFontList       dynamic         CSG
  349.           XmNbuttonRenderTable   XmCButtonRenderTable   XmRenderTable    dynamic         CSG
  350.           XmNcancelButton        XmCWidget              Widget           Cancel button   SG
  351.           XmNdefaultButton       XmCWidget              Widget           dynamic         SG
  352.           XmNdefaultPosition     XmCDefaultPosition     Boolean          True            CSG
  353.           XmNdialogStyle         XmCDialogStyle         unsigned char    dynamic         CSG
  354.           XmNdialogTitle         XmCDialogTitle         XmString         NULL            CSG
  355.           XmNfocusCallback       XmCCallback            XtCallbackList   NULL            C
  356.           XmNlabelFontList       XmCLabelFontList       XmFontList       dynamic         CSG
  357.           XmNlabelRenderTable    XmCLabelRenderTable    XmRenderTable    dynamic         CSG
  358.           XmNmapCallback         XmCCallback            XtCallbackList   NULL            C
  359.           XmNmarginHeight        XmCMarginHeight        Dimension        10              CSG
  360.           XmNmarginWidth         XmCMarginWidth         Dimension        10              CSG
  361.           XmNnoResize            XmCNoResize            Boolean          False           CSG
  362.           XmNresizePolicy        XmCResizePolicy        unsigned char    XmRESIZE_ANY    CSG
  363.           XmNshadowType          XmCShadowType          unsigned char    XmSHADOW_OUT    CSG
  364.           XmNtextFontList        XmCTextFontList        XmFontList       dynamic         CSG
  365.           XmNtextRenderTable     XmCTextRenderTable     XmRenderTable    dynamic         CSG
  366.           XmNtextTranslations    XmCTranslations        XtTranslations   NULL            C
  367.           XmNunmapCallback       XmCCallback            XtCallbackList   NULL            C
  368.  
  369.                                                 XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  370.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  371.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel               dynamic                CSG
  372.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  373.           XmNforeground             XmCForeground           Pixel               dynamic                CSG
  374.           XmNhelpCallback           XmCCallback             XtCallbackList      NULL                   C
  375.           XmNhighlightColor         XmCHighlightColor       Pixel               dynamic                CSG
  376.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap              dynamic                CSG
  377.           XmNinitialFocus           XmCInitialFocus         Widget              dynamic                CSG
  378.           XmNlayoutDirection        XmCLayoutDirection      XmDirection         dynamic                CG
  379.           XmNnavigationType         XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  380.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList      NULL                   C
  381.           XmNshadowThickness        XmCShadowThickness      Dimension           dynamic                CSG
  382.           XmNstringDirection        XmCStringDirection      XmStringDirection   dynamic                CG
  383.           XmNtopShadowColor         XmCTopShadowColor       Pixel               dynamic                CSG
  384.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap              dynamic                CSG
  385.           XmNtraversalOn            XmCTraversalOn          Boolean             True                   CSG
  386.           XmNunitType               XmCUnitType             unsigned char       dynamic                CSG
  387.           XmNuserData               XmCUserData             XtPointer           NULL                   CSG
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 10/3/02)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                                   CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  405.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  406.           XmNchildren         XmCReadOnly         WidgetList    NULL      G
  407.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  408.           XmNnumChildren      XmCReadOnly         Cardinal      0         G
  409.  
  410.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  411.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  412.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  413.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  414.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  415.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  416.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  417.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  418.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  419.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  420.           XmNdepth                        XmCDepth                        int              dynamic                CG
  421.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  422.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  423.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  424.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  425.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  426.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  427.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  428.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  429.           XmNx                            XmCPosition                     Position         0                      CSG
  430.           XmNy                            XmCPosition                     Position         0                      CSG
  431.  
  432.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  433.           A pointer to the following structure is passed to each
  434.           callback:
  435.  
  436.           typedef struct
  437.           {
  438.                   int _r_e_a_s_o_n;
  439.                   XEvent *_e_v_e_n_t;
  440.           } XmAnyCallbackStruct;
  441.  
  442.           _r_e_a_s_o_n    Indicates why the callback was invoked
  443.  
  444.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback
  445.  
  446.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  447.           XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx includes the translations from XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr.
  448.  
  449.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  450.           The XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx widget has the following additional
  451.           behavior:
  452.  
  453.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
  454.                     Calls the activate callbacks for the cancel button
  455.                     if it is sensitive.
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 10/3/02)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
  471.                     Calls the activate callbacks for the button with
  472.                     the keyboard focus.  If no button has the keyboard
  473.                     focus, calls the activate callbacks for the
  474.                     default button if it is sensitive.
  475.  
  476.           <<<<OOOOkkkk BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  477.                     Calls the callbacks for XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk.
  478.  
  479.           <<<<CCCCaaaannnncccceeeellll BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  480.                     Calls the callbacks for XXXXmmmmNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk.
  481.  
  482.           <<<<HHHHeeeellllpppp BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  483.                     Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk.
  484.  
  485.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  486.                     Calls the callbacks for XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk.
  487.  
  488.           <<<<MMMMaaaapppp>>>>:    Calls the callbacks for XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  489.                     parent is a DialogShell.
  490.  
  491.           <<<<UUUUnnnnmmmmaaaapppp>>>>:  Calls the callbacks for XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  492.                     parent is a DialogShell.
  493.  
  494.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  495.           The bindings for virtual keys are vendor specific.  For
  496.           information about bindings for virtual buttons and keys, see
  497.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  498.  
  499.      RRRREEEELLLLAAAATTTTEEEEDDDD
  500.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd(3),
  501.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeEEEErrrrrrrroooorrrrDDDDiiiiaaaalllloooogggg(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeIIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnnDDDDiiiiaaaalllloooogggg(3),
  502.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeessssssssaaaaggggeeeeDDDDiiiiaaaalllloooogggg(3),
  503.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeQQQQuuuueeeessssttttiiiioooonnnnDDDDiiiiaaaalllloooogggg(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeemmmmppppllllaaaatttteeeeDDDDiiiiaaaalllloooogggg(3),
  504.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeWWWWaaaarrrrnnnniiiinnnnggggDDDDiiiiaaaalllloooogggg(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeWWWWoooorrrrkkkkiiiinnnnggggDDDDiiiiaaaalllloooogggg(3),
  505.           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), and XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxxGGGGeeeettttCCCChhhhiiiilllldddd(3).
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 10/3/02)
  526.  
  527.  
  528.  
  529.